/*
 * $Id: QEBand.h 97 2009-07-19 04:16:42Z jon@bway.net $
 * Sleeper
 *
 * Created by Jon Gordon on 4/22/09
 * Copyright Jon Gordon.  All rights reserved.
 * 
 * Permission is hereby granted, free of charge, to any person obtaining 
 * a copy of this software and associated documentation files (the
 * "Software"), to deal in the Software without restriction, including 
 * without limitation the rights to use, copy, modify, merge, publish, 
 * distribute, sublicense, and/or sell copies of the Software, and to 
 * permit persons to whom the Software is furnished to do so, subject to 
 * the following conditions:
 * 
 * The above copyright notice and this permission notice shall be
 * included in all copies or substantial portions of the Software.
 * 
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
 * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 
 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */


#import <Cocoa/Cocoa.h>


@interface QEBand : NSObject {
@private
    NSNumber *bandUid;
    NSString *name;
    NSDecimalNumber *lLimit;    // lower frequency limit (MHz)
    NSDecimalNumber *hLimit;    // upper frequency limit (MHz)
    NSDecimalNumber *placeHolder;
}

+ (NSArray *)allBandsAsArray;
+ (QEBand *)bandForUid:(NSNumber *)uid;
+ (QEBand *)bandForName:(NSString *)bandName;
+ (QEBand *)bandContainingFrequency:(NSDecimalNumber *)frequency;
+ (BOOL)validateBand:(id *)ioValue error:(NSError **)outError;
+ (BOOL)isValidBandName:(NSString **)namePtr;

-(id)initWithUid:(uint32_t)newUid 
            name:(NSString *)newName 
     lLimitAsStr:(NSString *)newLLimit 
     hLimitAsStr:(NSString *)newHLimit 
placeHolderAsStr:(NSString *)newPH;

-(id)initWithUid:(NSNumber *)newUid 
            name:(NSString *)newName 
          lLimit:(NSDecimalNumber *)newLLimit 
          hLimit:(NSDecimalNumber *)newHLimit 
     placeHolder:(NSDecimalNumber *)newPH;

- (BOOL)containsFrequency:(NSDecimalNumber *)frequency;

- (NSNumber *)bandUid;
- (NSString *)name;
- (NSDecimalNumber *)lLimit;
- (NSDecimalNumber *)hLimit;
- (NSDecimalNumber *)placeHolder;
@end
